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1. About this guide 


Objectives and target audience 
This guide describes how to install and configure the Skrill xt:Commerce module. It assumes that you 
have an existing xt:Commerce installation. 


Conventions used in this guide 
The table below lists some of the conventions used in this guide. 


Table 1-1: List of conventions 

















Convention Description 

Code example Used to illustrate example code, functions and commands. 
File path Used to indicate a file path or folder structure. 

Glossary Glossary term 

Menu1 > Menu option2 > Indicates a menu path. 
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2. Introduction 


What is the xt:Commerce module? 


xt:Commerce is an eCommerce platform, which provides online merchants with a flexible shopping cart 
system, as well as control over the look-and-feel, content and functionality of their online store. 


Xt:Commerce has been fully integrated with Skrill’s online payment solution called Quick Checkout. 
Installing and configuring the Skrill Payment Solution module provides a simple, secure and convenient 
option for connecting to Skrill’s online payment processing platform via xt:Commerce. 


Skrill customers using xt:Commerce have access to a wide range of card and alternative payment 
methods. 


Signing up for a Skrill account 
Before you can start accepting payments through Skrill, you need to open a free merchant account by 
completing the online application form here. 


Once your application has been approved you can configure your Skrill credentials in your Skrill 
merchant account and then copy them in the your xt:Commerce backend and start taking payments. 
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3. Installing and configuring xt:Commerce 


Secret Word and API Password 

It is mandatory to setup a secret word and API/MQI password for your Skrill merchant account before 
configuring the Skrill xt:Commerce module. The secret word is used to authenticate the data sent back 
to your xt:Commerce server after payment. You must obtain the IP address of your xt:Commerce server 
to configure the API/MQI password. You can find this IP address by executing the following command 
from a command prompt: 

ping <server domain name> 
For example: 


ping example. xt:commerceserver.com 
Pinging example. xt:commerceserver.com [145.76.160.206] with 32 bytes of data: 


Make a note of the set of numbers in the square brackets. This is the IP address. Now you have the IP 
address, you can setup the secret word and API/MQI password as follows: 


Log in to your Skrill merchant account at www.skrill.com 


1 

2. Go to Settings > Developer Settings (Figure 3-1) 

3. Set API / MQI Password using the toggle, type and confirm by clicking Save 

4. For each section, specify the IP address(es) or IP address range of your xt:Commerce 
server. This prevents payment or money transfer requests from other IP addresses if your 
secret word or API password is compromised. All requests from other IP addresses are 
denied. Access can be granted to: 


e Asingle IP address (e.g. 145.76.160.206 using the example above) 
e Multiple IP addresses, separated by space (e.g. 192.168.0.2 10.0.0.2) 


e Asubnet in CIDR notation (e.g. 192.168.0.0/24) 

5. Set Secret Word using the toggle, type and confirm by clicking the Save button 
Note: Your Secret Word must contain at least: 8 characters, 1 uppercase letter, 1 lowercase 
letter, and 1 number. 
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Home > Setting 








GY Home Developer Settings 
Configure API and security settings for your wallet account 
> Transt 
Bla Bla Wallet 
@ Banking ID: 116404455 
Œ Balances Developer Settings : Bla Bla Wallet BIN mmm i S SE mm DIH ba E+] = i m 
S All Transactions Wallet IP Whitelisting API / MQI / GSR / CVT Management API Documentation 
8u 
C) Automated Payment Interface (API) Disabled ©] 
© settings 
Allow requests to the API only from the following IP addresses. 
& Account Settings Your API secure IP addresses: ( Edit + add) 








867.120.141.129 


© me 





C) Merchant Query Interface (MQI) Disabled 


Allow requests to the MQI only from the following IP addresses. 


Your MQI secure IP addresses: + Add ) 


No active secure IP address found 








[E Gateway Secure Restriction (GSR) Disabled 


Allow gateway sessions to be generated only from the following IP addresses. 


Your GSR secure IP addresses: 


©) SetAPI/MQIPassword Enabled 


Please provide API/MQI Password in order to enable the service. 


Current Password 
New Password 


Confirm Password 


ae 


E SetSecretWord Enabled 


Please provide Secret Word in order to enable the service. 


New Password 


Confirm Password 


ae 


tings | Privacy Notice | Regulatory Disclosures | Cookie Notice 





(©2020 Paysafe Holdings UK Limited. All rights reserved. Sill? is a registered trademark of Paysafe Holdings UK Limited. Skrill Limited is registered in England and Wales with company number 04260907 and its registered office at 25 Canada Square, London E14 SLO. Authorised and regulated by the Financial Conduct 


Figure 3-1: Configuring a Secret Word and API/MQI Password 


Download Skrill on your xt:Commerce backend 
The next stage of the xt:Commerce integration is to configure the xt:Commerce module to connect to 
your Skrill account. The steps are as follows: 


Login to your xt:Commerce admin account. 


Select configuration 
Go to method of payment 
Find Skrill 


PWN PP 
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5. Click edit to configure Skrill (Figure 3-2) 


Merchant Account (email): merchant@company.com 
Merchant ID: 112233445 

MQI Password: skrill123 

API password: skrill123 

Secret word: skrill 


Figure 3-2: Skrill Settings with example values in xt:Commerce backend 


Configure Skrill Settings 


Configure the Skrill Settings as follows: 


1. Enter your Skrill Merchant account email address 

2. Enter your Skrill Merchant account ID in the Merchant ID field. This is the Customer ID of your 
merchant account 

3. Enter the MQI/API password you configured in your Skrill merchant account 

4. Enter Secret word that you set up in the previoussection 


Table 3-1: Skrill Settings 





Field Name Description Format/ Example 





Merchant ID Your unique merchant identifier. This is the 58010731 
Customer ID of your merchant account 





Merchant The email address linked to your Skrill merchant | techpubs@skrill.com 
Account (email) | account (created by you when you first signed up 
for a Skrill merchant account) 





API/MQI The API/MQI password. This field is mandatory. It| N/A 
Password allows the xt:Commerce server to receive 
payment information 





Secret word Enter the secret word configured for your Skrill N/A 
account here. This feature is mandatory and 
ensures the integrity of the data posted back to 
your xt:Commerceservers 
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4. Customer Experience 


This section describes the customer’s checkout experience when using the Skrill xt:Commerce module. 


Note: We only describe the Checkout process from the payment selection step onwards as the previous 
steps are unchanged. 


The steps are as follows: 


1. Click on Skrill to see all available local payment methods which can be used to complete the 
payment: 


Choose the delivery choose. the payment. method 


Select the desired payment method. 


SHIPPING ADDRESS 


Pay securely with Skrill i 

Customer Last name x 7 Skrill 
High street , . 
E1 7YT London Obitcoin Bitcoin SEPA SEPA Direct Debit 
Germany 

: MAPIOS Rapid transfer VISA Se VISA, Mastercard, 
BILLING ADDRESS 

Comments 

Customer Last name 
High street 
E1 7YT Londor 


Germany 


< Back 


Figure 4-1: xt:Commerce Checkout Payment selection showing different payment methods 


2. 
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Enter Payment details in the Skrill Payment Form 


® English Germany 


30.60euR o 


= 
S visa 


Card number 


Expiry date Security code 
MM YY CVV 


Cardholder name 


Type the name exactly as it appears on the card 


PAY NOW 


Cancel 


g= Skrili 


Figure 4-2: Enter Payment Details in the Skrill Payment Form 


10 
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3. Click Pay Now to complete the payment. If all is correct, the payment form will display the 
following screen: 


@ English Germany 


30.605 © 


A 





Successful payment 





= a 
g Skrill 
Figure 4-3: Successful Payment 


4. Click Continue to return to the xt:Commerce Order Confirmation screen 


Your order has been completed successfully 


Your order has been received and will be processed immediately. You have received a confirmation e-mail with the order data to check! 


We thank you for your online purchase! 


Further 


Figure 4-4: Order Confirmation in xt:Commerce Checkout 
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Removing or reducing the header and reducing the footer 

You can request a version of the Skrill payment form without the Skrill header and amount fields. The 
security logo is also removed from the footer, to reduce its size. To enable this option, please contact 
Skrill Merchant Services and ask for the Reduced Header and Footer option. This option is shown in 
the screenshot below (The standard payment form is shown on the left and the reduced header and 
footer option on the right). 


© Engish France 
10.00«ve : 
@ Engish France © English RARR 
= 0 = = 
d = 
-= © =p © 
visa SD 
visa SD vss € 
a TE 
Expiry date Sec code 
MM YY CV = s ya Expiry date Security code 
MM YY cvv = 
MM | YY cw E 
Cardholder name Cardholder name 
First Last First 5 Cardholder name 
irst Last 
First Last 
Email address Why? Email address Why? 
Email address Why? 
ayga E i Powered by 
v Skrill Zm- Skrill Powered by Skrill 


Figure 4-5: Reduced Header and Footer Option 
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5. Payment Information 
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The xt:Commerce module provides payment information in the Order screen with information about 


the payer. 


order ID: 13057 (08/20/2020) order status: Payment received 


billing address: 


Customer Last name 
High Street 

E1 7YT London 
Germany 


customer details 


date of birth 


08/10/1999 (21 Years) 


last modified: 2020-08-20 19:13:43 


delivery address: 


Customer Last name 
High Street 

E1 7YT London 
Germany 


information 


E-mail address 


customer status (order) Guest 
customer status Guest 
Phone 000000000 
payment code xt_skrill 
shipping code default 
language German 
Billing Phone 000000000 


Figure 5-1: Payment Information Example 


Refunding Payments 
To complete refund, please login to your Skrill merchant account and follow the below steps: 


1. Click on All transactions 

2. Find the transaction which should be refunded 

3. Click partial refund from right hand side column 

4. Type the amount which should be refunded (full/ partial refund) 
5. Click confirm return 


This will ensure money are returned to the customer, however, to update your xt:Commerce backend, 
please follow the below steps: 


1. Goto Orders/Customers 

2. Click on Orders 

3. Search for the customer’s invoice 

4. Click the correct Order to view more information 
5. Check that the details are correct 

6. Select Refunded (Figure 5-2) 

7. Click on Save 
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xt:Commerce [resoa | oser =f oser 13057 = M 


a ()SAFECHARGECOMpany f Edit order items Add item © Edit coupon 35 Edit addresses għ} Payment 


xt: Commerce 5.1.3 
= Shop 
y orders / customers 
a Py order 
customers 
customer status 


© Hermes parcels 
E lill shipcloud parcels 


È content 
E configuration 
@® Plugins 


[<] 


ONE 


AAAA 


[+] 


+] 


(+] 





added 
2020-08-20 18:57:16 
2020-08-20 19:10:34 
2020-08-20 19:13:43 


order status notification 
Open (=) 
Open © 
Payment received (=] 














Shipment number: | Pending 
Payment received 
Payment Canceled 

Shipper: Shipped 

— i Canceled 

nd info emai m, 

for customer: Refunded 
Partially refunded 
Payment pending 

4 Payment Denied 

change order statu Payment reversed 

en Payment Failed 
Payment Expired 
Pending (Klarna) 

nied (Klarna) 
order status: 















Figure 5-2: Refund Payment 
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6. Testing 


We provide test cards shown in the table below for use with test merchant accounts. When using 
these card numbers enter an expiry date in the future and a random CVV number. 


Table 6-1: Test Cards 











Brand Card Number 
MasterCard 5438311234567890 
Visa 4000001234567890 














Should you wish to test Skrill in DEMO shop please get in touch with Skrill support at 


newbusiness@paysafe.com, so we can provide you with access. 
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